home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / grafik / bildanzeiger / jpegaga / doc / jpegaga.doc < prev    next >
Text File  |  1995-03-09  |  11KB  |  317 lines
  1.  
  2.                          jpegAGA 1.1 by Günther Röhrich
  3.                          ******************************
  4.  
  5.  
  6. jpegAGA is, at this time, the highest quality JPEG viewer (if a map-file for
  7. that picture is available) To use it you need the AGA chipset, a 68020 or
  8. higher processor and OS 3.0 or higher. This program uses the HAM8-mode, gray-
  9. scale display will use 256-color-mode.
  10.  
  11. If a precomputed colormap (a file with the ending .map) is available then
  12. the picture will be displayed in a much higher quality compared to other
  13. viewers.
  14. With the supplied shell script you can create such map-files for all your
  15. pictures. These files will only be 198 bytes long.
  16.  
  17. If a map-file is not available then you will get a lower quality display. For
  18. grayscale display this file is not needed.
  19.  
  20. The advantages of jpegAGA:
  21. - very high quality (better than any other viewer)
  22. - complete source is available
  23. - best compatibility to all JPEG pictures because the unmodified JPEG source
  24.   from the Independent JPEG group is used for decoding
  25. - high speed gained by using the GNU C compiler and the 24-bit-RGB to HAM8 con-
  26.   verter written directly in assembly language
  27. - support for grayscale JPEG's and for showing color pictures in grayscale
  28.   format
  29.  
  30.  
  31. This program and the supplied source is Public Domain, you can do what you want
  32. with it. For the JPEG-source please read the file README.
  33.  
  34.  
  35.  
  36. I have to thank the following persons/groups:
  37.  
  38. The Independent JPEG Group (jpeg-info@uunet.uu.net):
  39.  for the source to decode/encode the JPEG picture format
  40.  
  41. Free Software Foundation, Inc. and all contributors for the GNU C compiler
  42. and related tools
  43.  
  44. ***********************************************************************
  45.  
  46.  
  47. Now let's go on with the real documentation:
  48.  
  49.  
  50. Installation
  51. ************
  52.  
  53. Copy the programs from the bin directory anywhere into your shell's search
  54. path. The file name extensions are showing for what processors they are com-
  55. piled. After installation you should remove these extensions.
  56.  
  57.  
  58. Extension 000:  68000 and 68010 processors, runs on all others too
  59. Extension 020:  68020 or higher processors
  60.  
  61. All programs are compiled with GNU C 2.5.8 and need therefore the file 
  62. ixemul.library in the LIBS: directory.
  63.  
  64. For using the shell script CreateMap you have to assign JPEGTMP: to a directory
  65. on your hard disk with enough free space. (e.g. assign JPEGTMP: HD:T) The pro-
  66. grams djpeg and cjpeg will eventually need this directory too.
  67. The best solution is to add this command to the user-startup file.
  68.  
  69. The shell script CreateMap should be copied to the S: directory. It assumes that
  70. the programs djpeg and ppm2AGA are available (with exactly these names) in the
  71. shell's search path and the JPEGTMP: directory exists.
  72.  
  73.  
  74.  
  75. Invoking jpegAGA:
  76.  
  77.   jpegAGA inputfile options
  78.  
  79.  
  80. Inputfile
  81. *********
  82.  
  83. The name of the JPEG-file that should be read. If the picture is in grayscale
  84. format it will be shown on a 256 colors screen without extensive computations.
  85. Unfortunately there are also grayscale pictures encoded in color mode. You
  86. should use the -GRAY option for such pictures.
  87. When showing the picture in color mode the map-file for this picture will be
  88. used if it is available. The map-file must have the same name as the picture
  89. with the additional ending .map. To support the PC-filesystem it will also
  90. accept a name that has the extension replaced by ".map".
  91. If a map-file is found this will be notified in the console window.
  92.  
  93. Examples for file names:
  94.  
  95. picture file: picture.jpeg    map-file: picture.jpeg.map  or  picture.map
  96.               pic1.jpg        map-file: pic1.jpg.map      or  pic1.map
  97.  
  98. jpegAGA will also try to find the map-file in the directory pointed to by
  99. the environment variable MAPDIR. (new in version 1.1)
  100.  
  101.  
  102. Options
  103. *******
  104.  
  105. All options are case-insensitive. If they are not set then internal default
  106. values will be used.
  107.  
  108.  
  109. -GRAY
  110.  
  111. Display picture in grayscale mode.
  112.  
  113.  
  114. -BS
  115.  
  116. Use block-smoothing. You should set this option when the image has been
  117. encoded at a very low quality setting. Without this option you can see multi-
  118. ple blocks with a nearly constant color in the picture. When this option is
  119. set the borders of these blocks will be smoothed.
  120. You should use this option only for such cases.
  121.  
  122.  
  123.  
  124. -VGA
  125.  
  126. The picture will always use the VGA screenmode (also called 'multiscan') for
  127. display. Use this option when you know that the picture was intended for
  128. displaying on a PC or other machines with square  screen resolution.
  129. (this is the case for most JPEG-pictures)
  130.  
  131. NOTE: With 'square' I don't mean that the screen has the same number of pixels
  132. in horizontal and vertical direction. (e.g. 1024x1024)
  133. I mean that a square composed of e.g. 100x100 pixels will be shown as a
  134. square on the screen. Because a usual picture tube has a ratio of 4 to 3
  135. the screen's resolution must be a multiple of that. (e.g. 640x480 because
  136.  
  137.  640   4
  138.  --- = - )
  139.  480   3
  140.  
  141.  
  142. -SUPER72   (new in version 1.1)
  143.  
  144. This option will only be accepted if you also set the -VGA  option. The SUPER72
  145. screen mode will be used for very large pictures. You have to modify the SUPER72
  146. monitor driver in most of the cases (e.g. with the program "moned") if you want
  147. to get a square resolution in that mode.
  148.  
  149.  
  150. There is also a JPEG decompression program included. It converts JPEG
  151. pictures to the ppm format. (It is also needed for creating the map-files.)
  152. To use it enter:
  153.  
  154.  djpeg inputfile outputfile
  155.  
  156. In some cases djpeg will try to store temporary files to JPEGTMP:, you
  157. have then to assign this directory to somewhere on your hard disk.
  158. (for example assign JPEGTMP: HD:T)
  159. For more informations read the included documentation.
  160. With the program cjpeg you can create your own JPEG files.
  161.  
  162.  
  163.  
  164. Creating the map-files
  165. **********************
  166.  
  167. These files are needed for showing color picture with best possible quality.
  168. Normally, they are created by the shell-script CreateMap.
  169. Usage:
  170.  
  171.  CreateMap picturefile
  172.  
  173. After succesfull completion a map-file with the correct name will be created.
  174. (On PC-filesystems too) You can process several pictures with a single invo-
  175. cation. The command
  176.  
  177.  SPat CreateMap pictures/#?.jpg
  178.  
  179. will create, for example, a map-file for all pictures with the extension .jpg
  180. in the directory pictures.
  181. If it is not possible to store the map-file at the same location as the picture
  182. itself then it will be stored in the directory pointed to by the environment
  183. variable MAPDIR. jpegAGA 1.1 will then also try to find the map-file in that
  184. place. You can set the environment variable e.g. with the command:
  185.  
  186.  setenv MAPDIR HD:tempdir
  187.  
  188. If you reset your machine the variable will get lost. To prevent this you can
  189. use the command:
  190.  
  191.  copy ENV:MAPDIR ENVARC:
  192.  
  193. Now you can also show pictures from a CD-ROM with best possible quality.
  194.  
  195.  
  196. If problems occur please check the following:
  197.  
  198. - Have you installed everything as it is described in the section
  199.   "Installation" ?
  200.  
  201.   The files djpeg and ppm2AGA are needed under these names in the search path.
  202.   ixemul.library must exist in the LIBS: directory an the shell-script itself
  203.   must be in the S: directory.
  204.  
  205.   attention: - ppm2AGA must have version 1.4 or higher
  206.              - use djpeg from this distribution only
  207.  
  208.  
  209. - Have you assigned the directory JPEGTMP: correctly ?
  210.  
  211.  
  212. - Has the hard disk partion enough free space ?
  213.  
  214.  
  215. - Is enough memory available ?
  216.  
  217.   If not you can reduce memory usage by using the -M0 option with the shell
  218.   script. (See the documentation for ppm2AGA for more.)
  219.  
  220.   example: CreateMap pic.jpg -M0 or SPat CreateMap #?.jpg -M0
  221.  
  222.  
  223. - Is the disk, on which the JPEG-picture is stored, write enabled and does it
  224.   has enough free space ?
  225.  
  226. - Have you set the environment variable MAPDIR correctly ? You can check this
  227.   with the command: getenv MAPDIR
  228.  
  229. You can interrupt the shell-script at any time by pressing CTRL-C. In this case
  230. all temporary files in the directory JPEGTMP: will be removed automatically.
  231.  
  232.  
  233.  
  234. The picture screen
  235. ******************
  236.  
  237. You can move it around with the mouse. It also has an invisible, but full
  238. functional drag bar and depth gadget.
  239. Pressing the right mouse button will close the screen.
  240.  
  241.  
  242.  
  243.  
  244. If you have additional questions, suggestions for enhancements, bug reports,
  245. Mungwall/Enforcer hits, etc. then please contact me. It would also be nice
  246. if you would send me a corrected version of this manual. (and for ppm2AGA too)
  247.  
  248.  
  249.  
  250. History
  251. *******
  252.  
  253. 1.0 - 4-June-1994
  254.  
  255.     - first public release
  256.  
  257. 1.1 - 5-October-1994
  258.  
  259.     - added the option -SUPER72
  260.  
  261.     - the picture screen no longer flashes when closing it and the delay is much
  262.       smaller now
  263.  
  264.     - map-files will also be searched in the directory pointed to by the MAPDIR
  265.       environment variable
  266.  
  267.     - if a map-file is not found the user will get informed that he should
  268.       create one
  269.  
  270.     - file/path names of any length are now accepted
  271.  
  272.  
  273. Announcement
  274. ************
  275.  
  276. The actual version of this program does not offer very much. My spare time
  277. is very limited because I am now studying Electrical Engineering at the Uni-
  278. versity Stuttgart. Therefore I am searching for other developers to cooperate
  279. with me and beta-testers for testing purposes. If you want to join in then
  280. please contact me. I will then create a detailed description of the source.
  281.  
  282. To recompile ppm2AGA you need the newiff package from Commodore.
  283. V37 is available on Fish-disk 705, V39 on the "3.1 Amiga Developer Update"
  284. disks and on Aminet. 
  285.  
  286. Next I intend to write a PhotoCD viewer/converter with the picture quality
  287. of jpegAGA/ppm2AGA. This will be a free program too and I will also release
  288. the complete source. If you are interested in such a program it would be very
  289. nice if you would lend me some PhotoCD's for testing purposes. You will get
  290. them back together with my viewer/converter as soon as it will be working. If
  291. you give them to me as a present I will be even more happy. Your name will then
  292. be mentioned in the documentation and I will also send you the program.
  293.  
  294.  
  295.  
  296. To contact me write to:
  297.  
  298.   electronic mail:                                  normal mail:
  299.   ****************                                  ************
  300.  
  301.  Guenther@studbox.uni-stuttgart.de                  Günther Röhrich
  302.      (Internet EMAIL)                               Lerchenbergstr. 4
  303.                                                     73733 Esslingen
  304.                                                         Germany
  305.  
  306.  
  307. If you don't get an answer to a EMAIL within 3 weeks then try it again
  308. with normal mail.
  309.  
  310.  
  311. In the document "Info.Developer" you can read how to get other developer
  312. material, especially the "3.1 Amiga Developer Update".
  313.  
  314. NOTE: Commodore does not exist any more, I don't know if it is still possible
  315. to get developer materials there. Try to contact the German company
  316. Hirsch & Wolf oHG.
  317.